home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d26 / cattest.arc / MAKEQUES.LST < prev    next >
File List  |  1991-07-01  |  13KB  |  258 lines
  1.  A. To use the Make Question program [Note, the generic name of
  2.     this program is MAKEQUES, and the .EXE version is supplied.
  3.     It will have a name of the form MQxx.EXE on the disk, (xx
  4.     indicating a version number.)]
  5.     1. Menu Presented
  6.        a) (F)ile
  7.           1) (L)oad...An existing name.LIB file can be loaded for
  8.              editing, changing, cloning, etc.. Prior to loading, all
  9.              system variables are cleared, i.e., this will not append an
  10.              old question onto the back of a new one.
  11.           2) (N)ew...Cleans all variables and allows creation of a brand
  12.              new question.
  13.           3) (S)ave...Reminds you that you are over writing an existing
  14.              question (if that is the case) and then saves the question
  15.              and returns. Saved questions have the extension .LIB.
  16.           4) Save (a)s...Allows cloning of questions by saving them under
  17.              a different name (newname.LIB).
  18.           5) (W)rite...Creates the PASCAL text which is the ultimate
  19.              product.
  20.              >>>>This text is in the form of a 'name'.IN1 file, such that
  21.              the question driver (PROTOTP.PAS) executes an "include"
  22.              command which gets the 'name'.IN1 file and includes it
  23.              during Turbo Pascal compilation. Once a question has been
  24.              created (i.e., a .EXE file or a .OVR file has been made)
  25.              this 'name'.IN1 file can be discarded.
  26.              >>>>Alternatively, during editing of a question, one can
  27.              literally read the 'name'.IN1 file into the question driver,
  28.              and save the combined file as a complete question (after
  29.              removing the {$I 'name'.IN1} command! ususally by changing
  30.              '{$' to '{.$').
  31.           6) (D)irectory...Self explanatory.
  32.           7) (C)hange Directory...Self explanatory.
  33.           8) (Q)uit...If a (C)reate, (D)elete, E(X)change or (E)dit
  34.              command has been issued since the last (S)ave of Save (a)s,
  35.              a prompt will appear about quitting with or without saving.
  36.              Otherwise, this is the program exit.
  37.        b) (C)reate
  38.           Items which are created are APPENDed to the current question
  39.           file.
  40.           1) For variables, (I), (R), (S), the first query requests the
  41.              name (in our example, enter p2), and the second query
  42.              requests the definition (in our example, enter "random+1.").
  43.              Note that all names are adjusted by the program to contain a
  44.              prefix of the form 'I_', 'R_' or 'S_' to indicate the type
  45.              of variable being created.
  46.  
  47.           2) For the (A)nswer, it is required that a temporary variable
  48.              be defined, and then that variable used in the answer. Thus,
  49.              defining "answer" as a variable (real) in the example, means
  50.              that in the (A)nswer response one enters "R_answer", so that
  51.              the value of R_answer is the one being tested. This has been
  52.              implemented by forcing you to choose your answer from the
  53.              existing question's variables. Use the cursors to choose
  54.              either a (R)eal or an (I)nteger variable and then press
  55.              <ENTER>. It is a common error to try to use '0' as an answer
  56.              response, forgetting that you need to create a temporary
  57.              variable, call it zero, which the computer will rename
  58.              "R_zero", so that its value can be set equal to '0', and
  59.              then the answer response can be "R_zero". It is easier to do
  60.              than to explain.
  61.  
  62.           3) For error responses, the first query is either a previously
  63.              defined variable (remember to type in the prefixes properly}
  64.              or an expression using variables (remember to type in the
  65.              prefixes properly). The second query is for a response that
  66.              you wish to have the computer make if this error is inputted
  67.              by the student. The second item, your "help" for the
  68.              student, should be a complete sentence starting with a
  69.              capital letter and ending with a period, exclamation point,
  70.              or question mark. I prefer help responses phrased as
  71.              questions, but you choose whatever you want.
  72.                   For the (Q)uestion menu choice a special submenu is
  73.              invoked.
  74.              a> (T)ext-allows you to enter alphabetic characters  
  75.              b> (V)ariable-shows you all variables, and asks you to pick one
  76.                 by using the up and down arrows to highlight the desired
  77.                 variable, and then pressing the <ENTER> key to choose. Your
  78.                 choice must be a variable, either R_, I_ or S_ as the
  79.                 prefix. The nascent question text will show the variable
  80.                 with an A_ prefix, i.e, A_R_ to indicate that this is the
  81.                 alphabetic equivalent of the real variable.
  82.              c> (E)nd-finalizes the text and variables as a complete string.
  83.        c) (E)dit
  84.           Editing an item allows editing of either its PASCAL
  85.           representation or its defining second line. You can not
  86.           change the kind of item, i.e., Real to Integer. To do this,
  87.           erase (delete) the original, and then create the newer
  88.           version.
  89.        d) (D)elete
  90.           When an item is deleted, the place of that item is lost, so
  91.           that if something further down depends on this item, it
  92.           becomes undefined. Care must be exercised constantly to make
  93.           sure that all variables are either assigned or computed
  94.           using variables which themselves have already been assigned.
  95.        e) (L)ist
  96.           We use an example to illustrate both this item and the
  97.           complete program itself. (E)scape exits from this menu item.
  98.  
  99.                Choosing (L)ist causes the computer to create a
  100.           temporary file which contains a human readable form of the
  101.           question being created (MQ.TMP file). Below is an example
  102.           which shows how a question is displayed on the screen. Each
  103.           item has three lines of entry, the first is a signature of
  104.           the item type, (R)eal, (I)nteger, (S)tring, (Q)uestion,
  105.           (E)rror, (A)nswer  The second is the PASCAL representation
  106.           which will be used for that item. The third (not present for
  107.           the (Q)uestion and (A)nswer items), shows how that item will
  108.           be computed (if it is a variable), or what the response will
  109.           be (if it is an error).
  110.                Arrow keys move you about the display, ESCAPE exits the
  111.           display. Note that upon exiting, it is possible to save the
  112.           display as a text item on disk (MQ.TMP). This would allow
  113.           you to print this file after exiting the program.
  114.                The display example follows:
  115.           R
  116.           R_p2
  117.           random+1.
  118.           R
  119.           R_p1
  120.           R_p2*random+10.
  121.           R
  122.           R_v1
  123.           8.*random
  124.           R
  125.           R_v2
  126.           10.*random + R_v1
  127.           Q
  128.           ' If a gas under a pressure of ' + A_R_p1+' atm., occupying
  129.           ' + A_R_v1
  130.  
  131.           Q
  132.           ' liters is expanded against a constant pressure of ' +
  133.           A_R_p2+' atm. to a volume of '
  134.  
  135.           Q
  136.           A_R_v2 + ' liters, find the work.
  137.  
  138.           E
  139.           R_p2*(R_v2-R_v1)
  140.           Have you followed the sign convention for work in and out?
  141.           E
  142.           -R_p1*(R_v2-R_v1)
  143.           Did you use the wrong pressure?
  144.           R
  145.           R_answer
  146.           - R_p2*(R_v2 - R_v1)
  147.           A
  148.           R_answer
  149.  
  150.  
  151.        f) e(X)change
  152.           This menu choice allows you to interchange pairs of items in
  153.           the question, i.e., change the order. If you have added a
  154.           variable after the question rather than before it, you xan
  155.           interchange their positions using this instruction. The
  156.           screen will show you a compressed list of items, and you
  157.           choose two of them by pressing the space bar while they are
  158.           highlighted. Then, pressing <ENTER> results in the
  159.           interchange taking place.
  160.  
  161.     2. Changing an old question or cloning an old question into a
  162.        new question.
  163.        From the (F)ile menu of MAKEQUES, choose (L)oad and load an
  164.        existing question. Then edit the question, save it under a
  165.        new name, and (W)rite out the 'name'.IN1 file. For instance,
  166.        you could (C)reate a new (added) (E)rror response:
  167.           E
  168.           R_p2
  169.           Did you enter the ending pressure rather than the work?
  170.  
  171.  
  172.  B. To test a question after creating it using the Make Question
  173.     (MAKEQUES) program.
  174.  
  175.     1. Single question method.
  176.        Load Turbo, and use the FileNew command set to clear the
  177.        Turbo buffer. Press Ctrl-KR to execute the read command, and
  178.        then read "PROTOTYP.PAS" into the Turbo buffer. Choose a
  179.        name (here "name", presuambly the name of the .IN1 file
  180.        which you created using the MAKEQUES program), and change
  181.        every occurrence of the string "PROTOTYP" to "name". Locate
  182.        the {$I INITQUES.IN1} line, and either
  183.           change INITQUES to "name"
  184.           or
  185.           use Ctrl-K to read the 'name'.IN1 file
  186.           directly into the current program [if you
  187.           use this method, change {$I to {.$I].
  188.        Compile the program. If there are no errors, save the
  189.        program under "name.PAS" so that you can access this
  190.        question again at some future time.
  191.        If there are errors, correct them using the Pascal Editor.
  192.        When the Pascal errors are eliminated run the program
  193.        (either stand alone or in the IDE) and check that it is
  194.        correct (from a subject matter point of view).WARNING,
  195.        WARNING, WARNING!!!!!!! It is very disconcerting to students
  196.        to get the right answer, input it into the computer, and
  197.        have the computer respond that the answer is wrong! Remember
  198.        that pressing PF10 during program execution will bring up
  199.        the special (hidden) window which shows the variables in
  200.        your question. Students will not know about this window, but
  201.        you can check it to see that all variables have the values
  202.        you expect. Use the "\" key as the password to allow you to
  203.        view this screen.
  204.  
  205.  
  206.        a) Things to check that are likely errors.
  207.           1) question is too long.
  208.           2) variables in the question do not correspond to variables
  209.              which have been defined, presumably because these variables
  210.              were edited after the question had been created.
  211.           3) answer isn't a variable.
  212.  
  213.        b) Things to do once the question is checked.
  214.           1) You can save the question (under a new name) in either
  215.              compiled (i.e., compile to DISK) or text (Save) form,
  216.           2) You can edit away the marked off text and recompile to the
  217.              overlay form (to DISK).
  218.  
  219.     2. Throw away question method.
  220.        Load Turbo, and use F3 to load PROTOTYP.PAS. Locate the {$I
  221.        INITQUES.IN1} line and change INITQUES to the name used in
  222.        the MAKEQUES program when using the (W)rite command to
  223.        create the name.IN1 file. Compile and execute to your
  224.        heart's content, but at the end, do not save the text.
  225.  
  226.  C. To take questions (in .IN1 form) and create a PROCTORn
  227.     program which includes these questions run the program MTxx
  228.     MAKETEST). This will create the PROCTORn.EXE and the
  229.     PROCTORn.OVR files.
  230.  
  231.  D. To take a complete PROCTOR program (examination), and create
  232.     a student disk complete with password.
  233.  
  234.     1. WE ASSUME THAT THE STUDENT IS REQUIRED TO USE THE A: DRIVE.
  235.     2. For security reasons, if the student is using anything but
  236.        the A: drive, the PROCTOR program aborts. If security
  237.        warrants it, an emasculated copy of DOS can be used as the
  238.        A: boot disk, and each machine booted from this DOS disk, so
  239.        that you can be sure that no TSR's are loose in the system.
  240.     3. Put a clean diskette in the A: drive.
  241.     4. Run the program INITGRAD to create a password and a
  242.        GRADE.BK$ file on the student's disk (which is in the A:
  243.        drive of your machine).
  244.     5. Copy PROCTORn.* from the directory in which you created them
  245.        to the A: drive. The student diskette will contain
  246.        PROCTORn.EXE, PROCTORn.OVR, and GRADE.BK$ at the start of
  247.        the examination. At the end of the examination, it will also
  248.        contain Qn.$$$, where the data that the problems used is
  249.        stored (currently plain text), and Qn.UUC, uuencoded files
  250.        showing the history of how the student took the question.
  251.        Thus file may be read once it is uudec(oded).
  252.     6. Physically label the disk with the name of the student who
  253.        will receive this disk, and record in your private log the
  254.        password and name associated with this diskette.
  255.     7. Go back to step 3, and repeat the procedure for the next
  256.        student.
  257.  
  258.